This page last changed on Nov 19, 2014 by kgomes.

These instructions are for users who want to get the ESP control software (simulator too) up and running on their local machine. These were written for both CentOS.

Prerequisites

  1. Clean install of CentOS 6.6 (this has gcc 4.4 by default)

Steps to build and run

  1. I first logged in as kgomes
  2. Then opened a terminal window
  3. I changed to root using
    su
  4. I then created the log directory by doing
    cd /var/log
    mkdir kgomes
    chown kgomes:kgomes kgomes
  5. I made sure git was installed. It was not so I installed it using
    yum install git
  6. I also had to install autoconf using
    yum install autoconf
  7. And I had to install yacc using
    yum install byacc
  8. Then I changed to the root home directory using
    cd
  9. I created a directory I could work in using
    mkdir esp
  10. Changed into that directory using
    cd esp
  11. I needed to build the MBARI version of Ruby, so I checked it out from Brent's repo using
    git clone https://github.com/brentr/matzruby.git
  12. That created a matzruby directory which I then changed into using
    cd matzruby
  13. Not sure why, but running ./espconfig did not work due to some path problems so to fix this, I edited the espconfig file and adding './' in front of 'configure' in two places
  14. Then I was able to run espconfig this way
    ./espconfig
  15. Once that completed, I ran
    ./espinstall

    which installed the ruby executable in /opt/mbari/bin

  16. I then exited out of the root shell
    exit

    which put me back in my kgomes account

  17. I created a working directory by using
    mkdir esp
  18. Changed into it using
    cd esp
  19. I tried to clone the repository, but kept getting a 403 (unauthorized) error which I am sure had something to do with my git configuration as it would not ask for my username and password event though this is a private rep. To get around this, I just opened a browser, logged into to github and downloaded the zip file which I put in the esp directory. NOTE: I did verify this works with the Git clone as well. I had to create an SSH key and add that up on GitHub from the CentOS machine, then the git clone worked fine.
  20. Now, in order to setup the ESP environment so it can run on my machine, I edited my .bashrc file and add the following:
    export ESPhome=/home/kgomes/esp/ESP2Gscript-master
    export ESPname=gordon
    export ESPmode=simreal
    export ESPpath=.:$ESPhome/mission:$ESPhome/protocol
    export ESPconfigPath=$ESPhome/shallow:$ESPhome/shallow/$ESPname
    export PATH=$PATH:$ESPhome/bin:/opt/mbari/bin
    export RUBYLIB="${RUBYLIB:+$RUBYLIB:}$ESPhome/lib:$ESPhome/utils:$ESPhome/protocol"
  21. You should then source the .bashrc (or other) file to setup the environment
  22. Once this was done, I was successfully able to run
    esp

    to get the ESP server running

Document generated by Confluence on Feb 03, 2026 14:16